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PREFACE 



This manual describes the Lingage Editor included in the development package 
available as an option with the OASIS Operating System. 

This manual, named LINK , like all OASIS documentation manuals, has the manual name 
and revision number (if applicable) in the lower, inside corner of each page of the 
body of the manual. In most chapters of the manual the last primary subject being 
discussed on a page will be identified in the lower outside corner of the page. 



Belated Documentation 

The following publications provide additional information useful in the use of the 
this program: 

OASIS System Reference Manual 

OASIS EXEC language Reference Manual 

OASIS Text Editor Reference Manual 

OASIS MACRO Assembler Language Reference Manual 

OASIS Dynamic Debugger Reference Manual 
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CHAPTER 1 
BTTRODUCTIOH 

The OASIS Linkage Editor is a command program that is used to n link n together the 
output of an assembly or compilation process into an executable load module. This 
is a necessary step that follows the source program assembly or compilation of any 

groblem program (except those programs written for the EXEC language processor, the 
ASIS BASIC compiler /interpreter, or the OASIS COBOL compil or) . 

Every program is designed to fulfill a~ particular purpose. To achive that purpose, 
the program can generally be divided into logical units that perform specific 
functions. A logical unit of coding that performs a function, or several related 
functions, is a module. Ordinarily, separate functions should be programmed into 
separate modules, a process called modular programming. 

Each module is separately assembled or compiled by one of the language translators. 
The input to a language translator is a source module; the output from a language 
translator is an object module. Before an object module can be executed, it must 
be processed by the Linkage Editor. The output of the Linkage Editor is a load 
module. 

Source Program 

i 

\(/ 
Language Translator — — - > Program Lising 

I 

\l/ 

Object Program 

I 

\l/ 

Linkage Editor > Map Listing 

i 

\l/ 
Load Program 

Any module is composed of one or more program address blocks ( PABS) . A PAB is a 
unit of coding (instructions and data) that is, in itself, an entity. A PAB is the 
smallest separately relocatable unit of a program. 

Each module in the input to the Linkage Editor may contain symbolic references to 
PABS in other modules; such references are called external references. The symbol 
referred to by an external reference must be either the name of a PAB or- the name 
of an entry point in a PAB. PAB names and entry names are called external names. 
By matching an external reference with an external name, the Linkage Editor 
resolves references between modules. 

The following chapters discuss the syntax of the LINK command, the use and 
requirements of the input files to the Linkage Editor, and the output of the 
Linkage Editor. 
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CHAPTER 2 

LINK CGMMAHD 

The OASIS Linkage Editor is invoked by executing the 
the command is: 



LINK command. The syntax of 



Where i 



<ft> 



<fd> 



l&gK [<fn> [<ft> [<fd>]]] [(<option>. ..[)]] 



Indicates the file name of the object file to be linked or the file name 
of the specifications file (see FILE option). 

Indicates the file type of the object file to be linked or the file type 
of the specifications file (see FILE option). A default file type of 
OBJECT will be used when option FILE is not specified and a default file 
type of LINK will be used when option FILE is specified. 

Indicates the file disk of the object file to be linked or the file disk 
of the specifications file (see FILE option). When no <fd> is specified 
the default file search sequence will be used (see OASIS System Reference 
Manual) . 

LINK Options 

BOOT Indicates that the output is a bootstrap loader. When this option is 
specified the first 256 bytes of the output of the linkage is written to 
sector of the output drive. 

D£SK[sx] Indicates the drive that the output listing file is to be written to. 
When this option is specified the linkage parameters and map are written 
to a disk file with a file name equal to the <fn>, a file type of LINKMAP 
and the drive specified by this option. 



DRIVEsx 

FILE 
MAP 

1K»1AP 
NO£RINT 

IQTYPE 

NOXREF 



Indicates the drive that the output file is to reside on. When this 
option is not specified the output file will be on the same drive as the 
input file. 

Indicates that the file description specified is the file description of 
the file containing the LINK control parameters. 



Indicates that 
listing device, 



the linkage map is to be 
This is a defalut option. 



generated and output to the 



Indicates that the linkage map is not to be generated. 

Indicates that the linkage parameters and map are not to be output to the 
printer. This is a default option. 



Indicates that the 
the console. 



This option suppresses the 
default option. 



linkage parameters and map are not to be displayed on 
cross reference table generation. This is a 



£RINTER[n] Indicates that the linkage parameters and map are to be output to the 
printer specified. If n is not specified then PRINTER 1 is used. 



.SYSTEM 

TYPE 

HSR 

EPRKsx 
XREF 



For example; LINK CLASS2 
Indicates that the linkage parameters and map are to be displayed on the 

For examples LINK UPPER (USR 

When this 



Indicates that the output is a system file, 
(SYSTEM outputs the file SYSTEM. CLASS2-.S. 



console. This is a default option 

Indicates the the output is a BASICUSR file, 
outputs the file UPPER. BASICUSR. 



Indicates the drive to be used for the linkage work files, 
option is not specified the system disk will be used. 

This option is not implemented as of this release. 



When the LINK command is invoked with no file description specified the program 
will expect the specifications file to be entered from the console. In this mode 
the LINK prompt character (#) will be displayed when the LINK command is waiting 
for a command. 
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CHAPTER 3 

LINK INPUT FILES 

3*1 Specification File 

The link specification file is the input file that controls that basic operations 
of the linkage process. This file may be a console file or a disk file. It is not 
necessary to use the specification file, in fact, the normal simple linkages don't 
use this file. 

The specification file is normally used when two or more object modules are being 
linked together or when some parameters of the resulting load module need to be 
modified from the object code. 

To use the console as a specification file do not specify a file description when 
invoking the Linkage Editor. For example: >LINK (PRINT. 

To use a disk file as a specification file you must use the option FILE when 
invoking the Linkage Editor and there must be a file description specified. For 
example: >LINK TEST (FILE PRINT SYSTEM NOMAP. 

In the following subsections the term <expression> refers to an arithmetic 
expression involving constants, previously defined symbols, and the operators +, -, 
*, and /. For example: 

LABEL+23 

L0C1+4«10H 

1000H 

An expression is evaluated in a left to right manner with no operator precedence. 
Numeric constants may be in decimal or hexadecimal ( trailing H) . String constants 
are specified with single quote characters surrounding them. 

3.T.1 DEFINE Couand 

The DEFINE command allows you to assign a value to a symbol. The format of the 
command is: 

£E£IHE <symbol>=<expres3ion> 

Where: 

<symbol> Specifies the symbol that is to be assigned a value. This symbol must 
have already been defined by one of the included object modules. 

<expression> Specifies the value that is to be assigned to <symbol>. 

The DEFINE command is normally used to resolve an unresolved reference. 

3.1.2 BID Conand 

The END command marks the end of the input specification file records and instructs 
the Linkage Editor to output the load module and the load map. The format of the 
command is: 



When the END command is encountered the Linkage Editor attempts to resolve any 
unresolved references by searching all attached disks for object files with a file 
name the same as an unresolved reference. When a qualifying object file is found 
an INCLUDE is performed on that file. This process is repeated until the end of 
the table of unresolved references is reached. (Note: including a file in this 
manner may cause more unresolved references to be formed.) 

When all references have been resolved that can be resolved in this manner and 
there still remains one or more unresolved references an implied LIST command is 
performed and the Linkage Editor returns to the console for further commands. 

If there are no more unresolved references the load module is created on the 
specified or default disk, the load map is output to the list device and the 
Linkage Editor is exited. 

3*1.3 ENTRY Coaaand 

The ENTRY command allows you to specify the execution entry point of the load 
module. The format of the command is: 
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ENTR Y <ezpresslon> 

Where: 

<expression> Indicates the address of the entry point. 

An ENTRY command has precedence over any end-of-file instructions that might 
specify an execution entry point. 

3*1*4 XMGLUDE Conand 

The INCLUDE command is the primary command of the input specification file. The 
INCLUDE command instructs the Linkage Editor to locate, analyze and assimilate an 
object file into the load module. The format of the command is? 

INCL UDE <aodule nase>[ 9 <nodule oaae>] .. 

Where? 

<module#name> Indicates the name of the object file to be included at this time. 

The file type of the object file must be OBJECT. More than one module 

name may be specified with one INCLUDE command by separating the module 
names with commas. 

When the Linkage Editor receives an INCLUDE command it searches the attached disks 
for the module and includes the text and instructions of that module into the load 
module being built. 

3.1.5 IGNOEE Command 

The IGNORE command allows you to create a load module that contains unresolved 
references by instrucing the Linkage Editor to ignore certain symbols. The format 
of the command is: 

IGNORE <sy»b©l>[ s <symbol>3™ 

Where : 

<symbol> Indicates the symbol that is to be ignored by the Linkage Editor. More 
than one symbol may be specified with one IGNORE command by separating the 
symbols with commas. 

When a symbol is ignored by the Linkage Editor in this manner it is important to 
note that the reference to it is not actually taken out of the text of the load 
module— it merely references relative address zero. You should not ignore a symbol 
whose reference code is actually executed — the results will be undefined. 

3«1.6 LIST Comand 

The LIST command allows you to see all of the currently unresolved references. The 
format of the command is: 

U£T 

When the LIST command is encountered the Linkage Editor displays all currently 
unresolved references on the list device. 

3*1.7 HAME Couand . 

The NAME command allows you to specify a program name for the load module that is 
different from the default. (The default name will be the name of the first 
included object module.) The format of the command is: 

NAME <fn>r.<ft>irs<fd>1 

Where: 

<fn> Indicates the file or program name of the load module. 

<ft> Indicates the file type of the load module. When this parameter is not 
specified the default file type will be used. (The default file type is 
dependent upon options used in the LINK command.) 

<fd> Indicates the file disk of the load module. When this parameter is not 
specified the default file disk will be used. (The default file disk is 
dependent upon options used in the LINK command.) 
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3.1.8 OHIGIH CoMand 

The ORIGIN command allows you to change a relocatable load module into an absolute 
load module. The format of the command is: 

ORIG IM <expression> 

Where: 

<expression> Specifies the address that the load module is to be loaded at. 

The ORIGIN command causes the relocation table to be used to change all relocatable 
references to absolute references and changes the load module into an absolute 
command module (the relocation table is not included in the load module). 

3.1.9 OVERLAY Coanand 

The OVERLAY command is not implemented in this version of LINK. 

3.1.10 QUIT Conand 

The QUIT command allows you to abort the linkage process without creating a load 
module. The format of the command is: 

QUIT 

The QUIT command might be used when it is discovered that there are object modules 
required that have not been assembled yet or when the linkage is merely a test to 
determine unresolved references. 

3.1.11 REPLACE Cn—mri 

The REPLACE command allows you to change references from one, possibly undefined, 
symbol to another symbol. The format or the command is: 

REPL ACE <syMbol1>=<symbol2> 

Where: 

<symbol1> Indicates the symbol that is to be replaced. 

<symbol2> Indicates the symbol that is to replace <symbol1>. 

The REPLACE command provides an easy means of linking an unfinished program. For 
example, the program might have calls to subroutines that are unwritten as yet. 
The REPLACE command could be used to change these references to a dummy subroutine 
that does exist without making a lot of changes to the source program just for test 
purposes. 

Please note that symbols, as used by the Linkage Editor, are symbols defined as 
entry points, not just labels used in the assembly process. 

3*1.12 SET Cound 

The SET command allows you to change the values in the load module text. The 
format of the command is: ' ■ 

SET <expression>=<data>[ , <data>] ... 

Where: 

<expression> Specifies the address, relative to the base address of the load module 
of the text to be changed. 

<data> Is a list, separated by commas, of values that the text is to be changed 
to. 

The SET command is normally used in, and is invaluable for, the modifications of 
parameters, defaults, etc., of a program without the modification of the source 
program. 

3.1.13 CoHBents 

Comments may be placed in the specifications file by using the semicolon (;) 
character. The Linkage Editor treats all characters in a record following the 
semicolon as a comment and will merely include them in any listing file that it may 
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create. 

3.2 Object File 

An OASIS object file is the primary output file from the MACRO assembler and the . 
primary input file to the Linkage Editor. An object file is a binary stream, 
sequential format file of control and text records. Each record in an object file 
consists of a header section and a text section. The header section for each 
record contains three values % 

<reeord lengthXreeord typeXPAB number > 

Where: 

<record length> Specifies the number of bytes in the record, including the record 
length byte c 

<record type> Specifies the type of record with one of the following codes? 

01 PAB definition record (P) 

03 Text record (T) 

05 Relocation record (R) 

07 Entry definition record (E) 

09 External reference record (X) 

0B PAB to PAB reference record (F) 

OF End of file record (Z) 

<PAB number > Indicates which PAB the data following refers to. 

Following the header section of a record is the text section. This text section 
varies in structure from one record type to another. The following sub-sections 
describe the format of each record type. The letter in parentheses is the letter 
displayed by the OASIS LIST command for that record type.. 

3.2.1 PAB Definition Record (P) 

The PAB definition record specifies the PAB name, type, base address, and length. 
The PAB number and length are relative to the current object file only. 

<headerXpab lengthXpab naaeXpab typeXbase address> 

PAB types are coded as a number: 

01 s absolute 

02 s relocatable 

04 s common relocatable 

3.2.2 Text Record (T) 

The text record is normally the most common type of record in an object file. It 
contains the assembled instructions and data constants as specified in the source 
program. 

<headerXstart addrXdata>[<data>].«. 

3.2*3 Relocation Record (R) 

The relocation record specifies a list of addresses within a PAB that must have the 
load address of the PAB added to them to form accurate address references. 
Although relocation record(s) may appear anywhere in the object file before the end 
of file record it is normal for this type of record to immediately follow the text 
records affected (see examples). 

<header Xaddr >[ <addr>] ... 

3.2.4 Entry Definition Record (B) 

The entry definition record specifies an address within a PAB that has been 
specified as an entry point with the ENTRY instruction in the source program. 
Along with the address the entry label is specified. 

XheaderXentry addrXentry name> 

When the Linkage Editor encounters an entry definition record it saves the entry 
point location and label and also searches its unresolved references table looking 
for any references that can be resolved by this definition. 
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3.2.5 External Reference Record (X) 



The external reference record specifies an address within a PAB that is a reference 
to a label specified as an externally defined label with an EXTRN instruction in 
the source program. The address and label referenced is specified in this record. 

<headerXref fro* addrXref to naae> 

The Linkage Editor tries to resolve this external reference by matching it with its 
currently defined entry point locations (defined with the entry definition record). 
If no match is found the external reference data is saved in the unresolved 
references table. 

3.2.6 PAB to PAB Reference Record (F) 

The PAB to PAB reference record is a special type of external reference, similar to 

the external reference record. The main difference is that the referenced label 

was resolved by the assembler because the label was defined in another PAB of the 
same assembly. 

<headerXref from addrXref to pab>[<ref fro* addrXref to pab>]... 

The PAB to PAB reference record specifies a list of addresses within a PAB that are 
references to other PABs. 

The Linkage Editor uses the information in this record by adding the referenced 
PAB's base address to the referencing address and also adds the referencing address 
to the relocation table. 

3.2.7 End of File Record (Z) 

This record indicates the logical end of file for the object program. Normally 
this record is only two bytes in length (count and record type), when the source 
program contained an END statement that specified a starting address this record 
will also note the starting address and its' PAB number. In this latter case the 
record length will be five. 

<header>[<start pabXstart addr>] 

3.2.8 Object File Record Examples 

The following example object records are displayed as the LIST command displays 
them. This differs from the actual contents of the records in that the record type 
is displayed with the letter code instead of the numeric code and addresses are 
displayed in normalized mode instead of Z80 mode (low byte first). 



10 P 00 04 A2 MAP 02 0000 

08 T 00 00D9 7E19FF 

05 R 01 000A 0012 003F 

0D E 00 0039 MAP 

0D X 00 0052 HELPMSG 

09 F 00 004F 02 0086 01 

05 Z 00 0039 



PAB definition, record length 16, relative PAB 
number 0, PAB length of 1186, PAB name is MAP, 
PAB type is relocatable, base address of 0. 
Text record, record length 8, relative PAB 
number , addresses starting at 00D9 , text is 
7E 19 FF at locations 00D9, 00DA, and 00DB 
respectively . 

Relocation record, record length 5, relative 
PAB number 1, relative addresses 00OA, 0012, 
and 003F in that PAB must have the load addr- 
ess adaed to them before execution. 
Entry definition record, record length 13, 
relative PAB number 0, address 0039 is tne 
entry point named MAP (trailing spaces added). 
External reference record, record length 13, 
relative PAB 0, address 0052 references exter- 
nal label HELPMSG (trailing space added). 
PAB to PAB reference record, record length 9, 
relative PAB number 0, address 004F is a ref- 
erence to relative PAB number 2, address 0086 
is a reference to relative PAB number 1 . 
End of file record, record length 5, execution 
address is 0039 in PAB 0. 
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CHAPTER 4 

LMK OUTPUT FILES 

The output of the Linkage Editor generally includes two files: the load module and 
the listing file. The load module may be one of two forms dependant upon whether 
the load module is absolute or relocatable. 

Load modules, when output, are always output to a disk file. The listing file, 
when output, may be output to a disk file, the console (default), or to one of the 
attached printer devices, dependant upon the options specified to the Linkage 
Editor. 

4.1 Absolute Load Module File 

An absolute load module output by the Linkage Editor is an exact image of the 
program to be executed. The directory entry for this type of a file specifies the 
load address and the load address is the execution address. An example of this 
type of a load module is the SYSTEM. NUCLEUS sS. 

4.2 Relocatable Load Module File 

A relocatable load module output by the Linkage Editor consists of two sections. 
The first section is an exact image of the program to be executed if it were loaded 
at address zero. The second section is the relocation table for the first section. 

This relocation table consists of variable length records with the first byte 
specifying the word count. Following the word count byte are two byte entries 
(words) that specify relative addresses pf the load module that need to have the 
relocation constant added to them before program execution begins. The relocation 
constant is the load address of the program. This load address is not known until 1 
the program is actually loaded into memory by the system. 

The directory entry of a relocatable load module contains a record count that 
includes the recount count of both sections. Records in the first section are 
always 256 bytes in length. 

Host OASIS commands are distributed as relocatable load module files. 

4.3 Map Listing File 

The map listing file may be output to a disk file, the console or one of the 

Erinter devices, dependant upon the options specified to the LINK command. The 
ISK option will cause the listing file to be output to disk; the PRINTER option 
will cause the, listing file to be output to one of the printers; the TYPE option 
will cause the listing file to be output to the console (default); the NOTYPE 
option will cause the listing file to be suppressed. 

The map listing file consists of two sections. The first section is a listing of 
the input specifications file, including any comments. 

The second section is a memory map of the load module created by the Linkage 
Editor. This map is a listing of the PABs used in the load module. Listed with 
each PAB is the memory region used by the PAB, the PAB type, and the entry points 
defined in the PAB in ascending address sequence. 

At the end of the memory map the relative entry address is listed along with the 
total length of the load module. 
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A.1 Example One: Simple, Single PAB 

>MACRO CLASS6 

SYSTEM. CLASS6 - Hazel tine 1400-1500 

Addr Ob j-Code Line *** Source Statement *** 



04/28/80 15s 09 Page 1 
CL ASS6 o ASSEMBLE : S0URCE$$ 



0000 C33600 



0003 

0003 FE20 
0005 3804 
0007 CF40 
0009 AF 
000A C9 



000B 

000B FE10 
000D CA9F00 



0010 215F00 

0013 87 

0014 5F 

0015 1600 

0017 19 

0018 5E 

0019 23 
001 A 50 



001B 7A 
001 C B3 
001D — 
001 E 



001F 
001F 
0020 
0021 
0023 
0025 
0026 
0027 
0028 
002A 
002C 
002C 
002F 
0030 
0032 
0034 



1A 

FE8C 

2807 

4F 

3C 

C8 

CF40 

18F3 

FD7E07 

28ED 
CF4C 
18E9 



j Operates with 1420, 1500, 1510, 1520 
; Change leadin to ESC for 1410 and 1552 
MACLIB CLASS 



test if control 



6 INIT 
10+ 

11+ JP TRANIN 
12+ 

\IV 

15+TRANOUT: 

16+ CP 20H 

17+ JR C,CTL 

1 8+ SC DEVOUT 

1 9+ XOR A 

20+ RET 

21 + 

22+; test if dca x,y 

24+CTL: 



DLE ; 
Z,DCA ; 

eDwl « « W U La « 



25+ CP 

26+ JP 

27+ 

28+ IF 

30+ ENDIF 

31 + 

32+; point to proper entry 

33+ 

LD 

ADD 

LD 

LD 

ADD 

LD 

INC 

LD 



input vector 



is it control? 
brif is 

else, display as is 
clear cy 



is it 10H 
jump if is 



34+ 
35+ 
36+ 
" p + 



|8h 



test for not available 



LD 
OR 
SCF 
RET 



LD 

IMC 

CP 

JR 

LD 

INC 

RET 

SC 

JR 



A,D 
E 



39+ 
40+ 
41 + 
42+ 

43+; 

44+ 
45+ 

46+ 

47+ 

48+ 

49+ 

50+; put out codes until byte 

51 + 

52+WRITEs 

53+ 

54+ 

55+ 

56+ 

57+ 

58+ 

59+ 

60+ 

61 + 

62+WRFFDLY; 



HL,TAB1-2 ; point to indirect table 
A ; code times two 

; move to de 

; 16 bits 

; point to correct slot 

; get address in de 



E,A 
D.O 
HL.DE 

if. 
D,(HL) 



A,(DE) 

DE 

8CH 

Z,WRFFDLY 

C,A 

A 

Z 

DEVOUT 

WRITE 



63+ 
64+ 
65+ 
66+ 

6 I + 
68+ 

69+ 



LD 
OR 
JR 
SC 
JR 



A,(IY+7) 

A 

Z.WRITE 

DELAY 

WRITE 



is address = zero? 

set cy just in case 
return if is 

= OFFH 



;et byte 

ump 

ff delay code? 
; brif is 
move to reg c 
test for OFFH 
return if is 
else, write to console 
loop 

get delay rate 

any? 

no, ignore 

else, pause 

continue 
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0036 



0036 
0037 
003B 
003C 
0040 
0042 
0044 
0046 
0049 
004B 
004D 
004E 
004F 
004F 
0053 
0054 
0055 
0055 
0059 
005B 
005D 
005E 
005F 
0060 



B7 

FDCB057E 

C8. 

FDCB0576 

2013 

FDE5 

CF30 

FDBE40 

FDE1 

2802 

B7 

C9 

FDCB05F6 

C9 

FDCB05B6 

CBAF 

CF4E 

B7 

CO 

37 
C9 



70+; input char translate routine 

71 + 

72+TRANIN: 

??: 

79+ 
80+ 
85+ 
86+ 
91 + 



92+ 



IF 

IF 

ENDIF 

IF 

ENDIF 

IF 

ENDIF 

IF 

ENDIF 

IF 

ENDIF 

IF 

ENDIF 

IF 

ENDIF 

IF 

ENDIF 

ENDIF 

OR 

BIT 

RET 

BIT 

JR 

PUSH 

SC 

CP 

POP 

JR 

OR 

RET 

SET 
SCF 
RET 

RES 

RES 

SC 

OR 

RET 

SCF 

RET 



.NUL. 
.NUL. 

.NUL. 

.NUL. 



.NUL. 
.NUL. 
.NUL. 
.NUL. 
.NUL. 



7,(IY+5) 

Z 

6,(IY+5) 

NZ,ESC2 

IY 

GETSCR 

(IY+64) 

IY 

Z,ESC1 

A 



6,(IY+5) 



6,(IY+5) 

c6nesc 

A 
NZ 



clear cy 

is this conin device? 

no, return 

2nd char of esc sequence? 

brif is 

save iy 

point to scr 

is this an esc char 

restore iy 

brif is 

turn off cy 

return 

turn on code 
set cy 
return 

turn off sw 
fold the char 
go translate 
test if any 
yes, return 
turn on cy 
return 



00 9F 
00 9F 



009F 
00A1 
00A3 
00A5 
00A7 
OOAo- 
00AA 
00 AB 
00AD 
00AE 
00B0 
00B1 
00B3 
00B4 



OE7E 

CF40 

0E11 

CF40 

7C 

C660 

4F 

CF40 

C620 

4F 

CF40 

AF 

C9 



DCA 



Hazeltine 1500 

LD C »~» 

SC DEVOUT 

LD C.DC1 

SC DEVOUT 

LD A.H 

ADD 90 

LD C.A 

SC DEVOUT 

LD A.L 

ADD 32 

LD C.A 

SC DEVOUT 

XOR A 
RET 



lead 1 

lead 2 

col number 
bias 

display 
line number 
bias 

display 
clear cy 



00B5 
00B8 
OOBC 
00C0 
00C4 



DEFINE H0ME,~,DC2 
DEFINE CLEAR, ,FS.8CH 
DEFINE E0S,",CAN.8CH 
DEFINE E0L,"\SI,8CH 
DEFINE LEFT,BS 



LDK Rev B 



- 11 - 



LIMKAGB EMTOH REFEREHCE MAHDAL 







07 

09 

07 

09 

07 

09 

07 

07 

07 

07 

81 

08 

°d 

07 
08 

% 

81 

81 
81 
8? 
81 
85 
81 
8? 
8? 



3D T 00 007D 



00C6 1030 DEFINE RIGHT, DLE 

00C8 1146 DEFINE UP, ~ , FF 

OOCB 1269 DEFINE DOWN,~,VT 

OOCE 1392 DEFINE IL,~,SUB 

00D1 15T5 DEFINE IC 

00D2 1624 DEFINE DL,~,DC3 

00D5 1747 DEFINE DC 

00D6 1856 DEFINE EU,~,GS 

00D9 1979 DEFINE POnAeM 

OODC 2102 DEFINE POFF,*,US 

OODF 2225 DEFINE FON 

OOEO 2334 DEFINE FOFF 

00E1 2443 DEFINE BON«~,SOH 

00E4 2566 DEFINE BOFF/,US 

00E7 26 8Q DEFINE ULON 

00E8 2798 DEFINE ULOFF 

00E9 2907 DEFINE RVON 

OOEA 3016 DEFINE RVOFF 

3125 

OOEB 3126 END 

No assembly errors. 

>LIST CLASS6. OBJECT; A (OBJECT 

10 P 00 OOEB CODE 02 0000 
07 T 00 0000 C336 

80 T 00 0002 00FE2O3804CF40AFC9FE10CA9F0O215F0O875F1600195E23567AB337C8 
1A13FE8C28074F3CC8CF4Q18F3FD7E07B726EDCF4C18E9B7FDCB057EC8 
FDCB05762013FDE5CF30FDBE40FDE12802B7C9FDCB05F637C9FDCB05B6 
C6AFCF4EB7C037C9000000000000000000000000000000000000000000 
00000000000000 

0000000000000000000000000000000000000000000000000000000000 
00000000000E7ECF400E1 1 CF407CC6604FCF407DC6204FCF40AFC9 
0061 B500 
0OB5 7E12FF 
0077 B800 
00B8 7E1C8CFF 

T 00 008F BCOO 

T 00 OOBC 7E188CFF 

T 00 00 8D COOO 

T 00 OOCO 7E0F8CFF 

T 00 006F C400 

T 00 0OC4 08FF 

T 00 006B C600 

T 00 00C6 10FF 

T 00 0093 C800 

T 00 00C8 7E0CFF 

T 00 0073 CBOO 

T 00 OOCB 7E0BFF 

T 00 0081 CEOO 

T 00 OOCE 7E1AFF 

T 00 0085 D100 

T 00 00D1 FF 

T 00 0083 D200 

T 00 00D2 7E13FF 

T 00 0087 D500 

T 00 00D5 FF 

T 00 0097 D600 

T 00 00D6 7E1DFF 

T 00 0067 D900 

T 00 00D9 7E19FF 

T 00 0069 DCOO 

T 00 OODC 7E1FFF 

T 00 0063 DFOO 

T 00 OODF FF 

T 00 0065 EOOO 

T 00 OOEO FF 

T 00 0099 E100 

T 00 00E1 7E01FF 

T 00 009B E400 

T 00 00E4 7E1FFF 

T 00 0075 E700 

T 00 00E7 FF 

T 00 008B E800 

T 00 00E8 FF 



T 00 
T 00 
T 00 
T 00 
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81 
8? 

37 



02 Z 



00 007B E90O 

00 00E9 FF 

00 007D EA00 

00 OOEA FF 

00 0001 OOOE 0011 0061 0077 OOl 

0083 0087 0097 0067 00( 

007D 



>LINK CLASS6 (SYSTEM 

LINK version 5.4B 

Memory map for SYSTEM. CLASS6:S 

PAB-name Low High Length Type 

CODE 0000 OOEA OOEB REL 

Entry Address: 0000 

Total Length: OOEB (235 decimal) 

>DUMP SYSTEM CLASS6 S 



IF 008E 006F 006B 009: 
9 0063 0065 0099 009* 



CLASS6 

Entry Addr 



007: 
007! 



0081 008? 
008B 007i 



04/28/80 14:06 Page 1 



Sector 1764 (Track=68, 
0000: C33600FE 203804CF 



215F0087 5F16001 
13FE8C28 074F3CC 
28EDCF4C 18E9B7FD 
2013FDE5 CF30FDBE 
CB05F637 C9FDCB05 
C9B500DF 00E000DQ 
000000CB 00E700B8 
00CE00D2 00D100D5 
000000C8 000000D6 
7ECF400E 11CF407C 
4FCF40AF CQ7E12FF 
7E0F8CFF 08FF10FF 
FFFF7E13 FFFF7E1D 
FF7E01FF 7E1FFFFF 
00000000 00000000 



0010 
0020 
0030 
0040 
0050 
0060 
0070 
0080 
0090 
OOAO 
00B0 
00C0 
00D0 
00E0 

00F0 

Sector 1765 (Track =6 8 



0100 
0110 
0120 
0130 
0140 
0150 
0160 
0170 
0180 
0190 
01A0 
01B0 
01 CO 
01D0 
01E0 
01F0 



1A01000E 00110061 
006B0093 00730081 
00670069 00630065 
007B007D 00000000 
00000000 00000000 
00000000 00000000 
00000000 00000000 
00000000 00000000 
00000000 00000000 
00000000 00000000 
00000000 00000000 
00000000 00000000 
00000000 00000000 
00000000 00000000 
00000000 00000000 
00000000 00000000 



Sector=9) 
40AFCQFE 10CA9F00 
5E23567A B337C8U 
CF4018F3 FD7E07B7 
CB057EC8 FDCB057O 
40FDE128 02B7C9FD 
B6CBAFCF 4EB7C037 
00DC00C6 000000C4 
000000EQ 00EA0000 
000000E8 00C000BC 
00E100E4 0000000E 
C6604FCF 407DC620 
7E1C8CFF 7E188CFF 
7E0CFF7E 0BFF7E1A 
FF7E1QFF 7E1FFFFF 
FFFFFFOO 00000000 
00000000 00000000 
Sector=10) 
0077008F 008D006F 
00850083 00870097 
0099009B 0075008B 
00000000 00000000 
00000000 00000000 
00000000 00000000 
00000000 00000000 
00000000 00000000 
00000000 00000000 
00000000 00000000 
00000000 00000000 
00000000 00000000 
00000000 00000000 
00000000 00000000 
00000000 00000000 
00000000 00000000 



■ • • 0»»B«»»»»»« 

!_••_..• #Vz,7«. 

(..L - v 

....0.. §..(•... 
.-.7.. N..7 

.••••••••••o*««* 

• ck tcj • UtSj 1 

••••••• •• •• • 

• •• ••••••••••• 

a.w o 

•k. ..s 

iKtlcCtCt • • • • U • • 

• lo /•••••••••••• 

• ••••••••••••••a 

• •••••••OOC9O009 

• •••««aeees«aa*a 
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A«2 Example Tn©s Specification File 

This example is a listing of the specification file used to link the OASIS NUCLEUS 
command. Note the aboundant use of comments and the modularity of the object 
modules. This makes maintenance of the program easier and is the recommended 
practice for all programs other than the simple, single module code. 

The various DEFINES, IGNORES and SETs are used to customize various parameters to a 
specific configuration. 

The file is named NUCLEUS. LINK and is used by entering the commands 

>LINK NUCLEUS (FILE 



NAME SYSTEM. NUCLEUS s A 



Include 

INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 



N$BASE 

NilMU 

NJISC 

NJIDISKIO 

NJiKEYIN 

NJIDISPLA 

NnCONIN 

NiiCONOUT 

N! {PRINT 

NJ {DEVICE 

Ni {NUMBER 

NJIMULDIV 

NJJRECLOC 

NiiSNU 

NUBYTE 

NJlEXCLUS 

NUPEEK 

N»MSG 

N! {DIRECT 

Ni {ALLOC 

NiiDATE 

NUCLOCK 

NUTIMER 

N2IUTILIT 

NiMISC 

NJiCOMPAR 

NUESC 

NJJSEQIO 

NliOPEN 

NJ [CLOSE 

NilSEQDIO 

NJIDIRIO 

NiHXIO 

M {LOADER 

NJiERROR 

NJSNEWSYS 



Low memory assignments 

Multi user definitions 

System Call dispatch 

Disk I/O interface 

Console input line 

DISPLAY, SYSDISP 

CONIN, SYSIN. CONST 

CONOUT, SYSOUT 

PRTOUT, PRINT 

DEVINIT.DEVIN,DEVST,DEVOUT,DEVUNINI,PUTDEV 

NUMBER , HEXI , HEXO , DECI , DECO 

16 Bit MULTIPLY/DIVIDE 

Sector/File Locks 

Select-Next-User, Activate 

GETBYTE, PUTBYTE 

Lock maintence 

Peek at conout 

MSG Sender 

Volume directory management 

Volume space management 

Date & Time conversion 

TOD, MSEC, DELAY 

TEB Maintanence 

Set & Point to various areas 

Internal subroutines 

COMPARE/DISPATCH 

CONSOLE ESCAPE 

Non Disk Sequential I/O 

OPEN 

CLOSE 

Seq Disk I/O 

Direct I/O 

Indexed file I/O 

QUIT, FETCH, LOAD, PGMINIT, EXCMD 

ERRDISP,ERRQUIT 

NEWSYS 



Start of user area 



Initial Program Loader 

Size all banks 

Interupts, clocks 

Disk driver 

Bank select 

INT mode 1 

IPL init routine 



Include n$ipl 
include nsmusize 
include vg 
include vgdisk 
include vgbank 
include n$muim1 
include vginit 

DEFINE RSTIOsRET 

DEFINE RST18=RET 

DEFINE RST20=RET 

DEFINE RST28=DEBUG 

DEFINE RST30=RET 

DEFINE RST38=RET 

DEFINE NMIsRET 

DEFINE DISKOsVGDISK 

DEFINE DISK1=VGDISK 

DEFINE DISK2=VGDISK 

DEFINE DISK3=VGDISK 

IGNORE DISK* , DISK5 , DISK6 , DISK? 

SET NUCLEUS+3=55 J CLK1=55 

SET NUCLEUS+0EH=07BH ; Set switches ERRTEXT,RTC,HIST,MODE2 on 
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SET NUCLEUS+3EH=255 

SET NUCLEUS+46H=250 

SET CLKSW=085H 

SET LUB+0=() 

SET LUB+8=16 

SET LUB+9=16 

SET UCB0+23=250,30,10 

SET UCB1 +23=250, 30, 10 

SET UCB2+23=250,30,10 

SET UCB3+23=250,30,10 

SET UCBt6+2=79 

SET UCBl6+3=23 

SET UCBl6+4=6 

ORIGIN 

END 



Multi-user switch 

4 Mhz 

RTC avail. RST5=BP 

Disk s DEV1 

C0NIN=SYSTEM.DEV17 

C0N0UT=SYSTEM.DEV17 

Disk STP, SET 



Line length 
Page length 
Class = o (Hazel tine) 
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A.3 Sample Three: Multiple PABs 

This example shows a simple program example that uses two PABs. This program is 
incomplete in that it only checks to see if the operator has requested a help 
message display. When the operator has not requested a help message the program 
exits. At this point is where the normal program logic would he coded, possibly 
using additional PABs or the same ones. 

>EDIT EX3C0DE ASSEMBLE 
NEW FILE 



•INPUT 
EX3C0DE: 

EXSCODEs 



.TSTHELP: 



i> JLI.L4.C9 

REL 

ENTRY 



'Example 3 - multiple PABs* 

EX3C0DE 

HELP, HELPMSG, PROG 



PAGE: 



LINE: 



.NOHELP: 



PUSH 
,PUSH 

Ild 

LD 

LD 

CP 

JR 

INC 

INC 

DJNZ 

POP 
POP 
POP 
LD 

LD 
SC 
LD 

LD 

OR 

RET 

SC 

DJNZ 

SC 

JR 

POP 

POP 

POP 

JP 

END 



DE 
HL 
B,9 
DE,HELP 

&r 

NZ,. NOHELP 

DE 

HL 

.TSTHELP 

HL 
DE 
BC 
DE, HELPMSG 

B.9 

59 

B,C 

A,(DE) 

A 

Z 

2 

.LINE 

49 
.PAGE 

HL 

DE 

BC 

PROG 

EX3C0DE 



Save drive code 

Save sector 

Save parameter pointer 

Length 

Point to HELP lit 

Get byte 

Compare with token 
Branch if not equal 
Else bump pointers 

Loop 

Is HELP request - display 

Restore regs 



; Point to help message 

; Point to CONOUT 
; Get lines/page 
I Move to B reg 

Get character 

Test if end 

Return to OASIS if is 

Else display 

Loop 

Wait at bottom of page 

Display next page 

j Restore regs 
> 



*FILE 
W EX3C0DE.ASSEMBLE:A" filed 

>EDIT EX3HELP ASSEMBLE: A 

NEW FILE 

EDIT 

*INPUT 

EX3HELP: 

HELP: 
HELPMSG: 



*FILE 



TITLE 

REL 

ENTRY 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

END 



'Example 3 - Help Message Data* 

HELP.HELPMSG 

'HELP ',13 

•Function: To illustrate an example ',13 

' of a multi-PAB program ',13 

« linkage ',13 

13 

'Syntax: EX3C0DE C(options[)]3 9 ,13 

13 

'Where options are: ',13 

« PRINTERn output to printer # n',13 

' TYPE output to the console ',13 

• NOTYPE suppress output ',13 
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"EX3HELP . ASSEMBLE : A tt filed 

>EDIT EX3PR0G ASSEMBLE A 

NEW FILE 

EDIT 

•INPUT 

TITLE 'Example 3 - Program 1 

ENTRY PROG 
EX3C0DE: REL 
PROG: 

XOR A ; Clear return code 

SC ; Exit 

END 
•FILE 
"EX3PROG. ASSEMBLE: A" filed 

>MACRO EX3C0DE 

Pass one 

Pass two 

No assembly errors 

>MACR0 EX3HELP 

Pass one 

Pass two 

No assembly errors 

>MACRO EX3PR0G 

Pass one 

Pass two 

No assembly errors 

>LINK 

#INC EX3CODE,EX3PROG,EX3HELP 

#NAME EX3:S 

#END 

LINK version 5.4B 04/30/80 12:08 Page 1 

Memory map for EX3. COMMAND: A 

PAB-name Low High Length Type Entry Addr 

EX3C0DE 0000 002B 002C REL EX3C0DE 0000 

PROG 002B 

EX3HELP 002F 01 1B 00F0 REL HELP 002C 

HELPMSG 0033 

Entry Address: 0000 

Total Length: 01 1F (287 decimal) 
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LIMK ERRORS & MESSAGES 

*• File "zzzixzzz. OBJECT" not found 

This message is displayed following an INCLUDE command of a file that cannot be 
found on any of the attached disk drives, 

** Including 

This message is displayed when the Linkage Editor is performing automatic 
includes following an END command, 

•* Invalid character in expression 



Ls message is displayed when . an invalid expression is detected. Expression 
may only contain valid symbols (one to eight characters in length, must start 
with a letter and contain only letters, digits, dollar signs, and periods) 
numeric constants (must start with a digit and contain only digits, the letters 
A through F, and may be terminated with the letter ti) and the arithmetic 
operators; + - * /. 

** Invalid oo—aiMf 

** Hot Implemented 

** Relocation error 

Indicates that an expression containing relocatable symbols is in error. 
Usually the error is one of the following: a difference between two relocatable 
symbols of different PABs; the sum of two relocatable symbols; the product of 
two relocatable symbols] the quotient of two relocatable symbols; the product or 
quotient of a relocatable symbol and an absolute symbol. 

•• Too many segments 

Up to 128 segments or object modules may be included in one linkage. 

•• Undefined symbol 

An expression using symbols or the DEFINE, IGNORE, or REPLACE command reference 
an undefined symbol (a symbol not specified by an entry or external definition 
record). 
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